home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / lmouse.arc / LSET.DOC < prev    next >
Text File  |  1986-06-14  |  5KB  |  140 lines
  1.                    DOCUMENTATION FOR LSET.EXE
  2.          A KEYBOARD DRIVER FOR THE LOGITECH C7 LogiMouse
  3.  
  4.     WRITTEN BY MARK E JOHNSON  June 14, 1986
  5.                2272-F Benson Avenue
  6.                St. Paul, MN  55116
  7.                (612)-698-3686
  8.  
  9.                          HOW TO USE LSET
  10.  
  11.        Before running LSET, be sure that the mouse driver has been
  12.        loaded into memory by either running MOUSE.COM or by
  13.        including "DEVICE=MOUSE.SYS" in your CONFIG.SYS file.  If
  14.        you don't have the mouse driver in memory before running
  15.        LSET, the system will probably get hung and you'll have to
  16.        reset your computer.
  17.  
  18.        Run LSET by Typing its' name.  You will see a menu like the
  19.        one below:
  20.  
  21.        ---------------------------------------------------------------
  22.                                                 Waiting for Button
  23.  
  24.             Mouse Forward
  25.             Mouse Backward
  26.             Mouse Left
  27.             Mouse Right
  28.                                                  EXIT
  29.             Button 1 Down
  30.             Button 1 Up
  31.  
  32.             Button 2 Down
  33.             Button 2 Up
  34.  
  35.             Button 3 Down
  36.             Button 3 Up
  37.  
  38.             X scale 1-9
  39.             Y scale 1-9
  40.        ---------------------------------------------------------------
  41.  
  42.        To pick an option, move the cursor to anywhere on the line
  43.        on which the option is located, and press the left button of
  44.        the mouse.  The status line at the top of the screen will
  45.        show that the program is waiting for key sequences.  Press
  46.        the EXACT KEYSTROKES that you want the mouse to generate for
  47.        the given function.  When you are done, press the left
  48.        button of the mouse again to terminate the entry.
  49.  
  50.        NOTE: the X and Y scale options only expect a single digit
  51.        from 0 to 9.  You don't have to terminate the entry by
  52.        pressing a mouse key.
  53.  
  54.        When you are done defining keystrokes, move the mouse to the
  55.        line which contains "EXIT", and depress the left mouse
  56.        button.  When you do this, the definitions you have created
  57.        will be programmed into the mouse, and LSET will terminate.
  58.  
  59.  
  60.     The following are mouse settings I commonly use with various
  61.     software packages:
  62.  
  63.        WordStar or Turbo Pascal:
  64.        mouse forward:   <UP arrow>
  65.              backward:  <DOWN arrow>
  66.              left:      <LEFT arrow>
  67.              right:     <RIGHT arrow>
  68.        Button 1 press:  Cntrl-K Cntrl-B
  69.               release:  Cntrl-K Cntrl-K
  70.        Button 2 press:  Cntrl-R
  71.        Button 3 press:  Cntrl-C
  72.        X scale       :  4
  73.        Y scale       :  3
  74.  
  75.  
  76.        PC-Outline (Excellent public domain outline processor)
  77.        Same as Wordstar above except:
  78.        Button 1 press:  <INS>
  79.        Button 2 press:  <Return>
  80.        Button 3 press:  <Escape>
  81.  
  82.  
  83.                       IMPLEMENTATION NOTES
  84.  
  85.     1. This program was compiled with LATTICE C Version 2.14 using
  86.        the SMALL MODEL.  The Following files are required for
  87.        compilation:
  88.             LSET.C         The main program
  89.             KEY_SCAN.OBJ   Assembler keyboard routine
  90.  
  91.        To compile the program:
  92.            LC -MS LSET
  93.  
  94.        To Link the program:
  95.            LINK C+LSET+KEY_SCAN, LSET,, LC
  96.  
  97.             
  98.                         Program Structure
  99.  
  100.           DOS INTERFACE
  101.           The DOS routines are written in C with one exception which
  102.           is outlined in the next section.  I am very dissapointed
  103.           with the speed of the standard BIOS screen IO routines, so I
  104.           wrote my own.  The two GLOBAL variables LINE and COLUMN
  105.           contain the current cursor position.  Whenever a character
  106.           is written to the screen, these variables are updated.  The
  107.           routines I use are as follows:
  108.  
  109.           VOID vgotoxy(x,y)    sets the cursor position to line x,
  110.                                column y
  111.  
  112.           VOID clrs()          Clear the screen and home the cursor.
  113.  
  114.           VOID clreol()        Delete from current position to end of
  115.                                line.
  116.  
  117.           VOID vputc(mode,c)   Write character 'c' with attribute
  118.                                'mode' to current xy position.
  119.  
  120.           VOID vputs(mode,s)   Write string pointed to by 's' with
  121.                                attribute 'mode' at current xy
  122.                                position.
  123.  
  124.  
  125.           KEYBOARD INTERFACE
  126.       I had to resort to assembler to get the keyboard routines to
  127.           work properly.  KEY_SCAN.ASM simply calls the BIOS keyboard 
  128.           interrupt and returns the ASCII code and/or Extended code of
  129.           the last key pressed.
  130.  
  131.  
  132.           MOUSE INTERFACE
  133.           I elected to write my own mouse routines rather than the
  134.           routines supplied with the mouse.  The advantage of my
  135.           routines is that they are entirely written in C, and
  136.           therefore, in my opinion, easier to understand.  Another
  137.           reason was that the routines supplied by Logitech were
  138.           incomplete.
  139.  
  140.